home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / msgswap.arc / MSGSWAP.DOC < prev    next >
Encoding:
Text File  |  1991-06-08  |  5.3 KB  |  157 lines
  1.  
  2.  *TFS* Lucky Thirteen            MsgSWAP v1.01         FidoNet Address
  3.     2400-9600 Baud                    by                 (1:273/730)
  4.     (215-948-7734)               Chester Swap
  5.  
  6.                             LAST UPDATED 03/29/91
  7.  
  8.                  MsgSWAP is written in Clipper, S'87 Version
  9.  
  10.   MsgSWAP is a simple program intended to import and export FidoNet
  11. messages into PCBoard.  There's several others that do a good job of it
  12. already, but there's nothing like the control you have when you roll
  13. your own.  So I spent a long weekend rolling my own...
  14.  
  15.   What it won't do - Let's see...
  16.  
  17. Won't work for any mail tosser except Qmail by Greg Dawson
  18.       (I don't know how the others address 1.msg)
  19.  
  20. Won't export any message other than public
  21.  
  22. Won't export any message unless the "Echo" attribute is true, and after
  23. the message is exported the echo attribute is set to false.
  24.  
  25. Won't kill any messages at all
  26.  
  27. Won't create a new PCBoard MSGS file if one doesn't exist
  28.  
  29. Won't improve your sex life
  30.  
  31. Won't pay attention to the "Locked" field of the PCB message file (yet)
  32.  
  33.   What it will do...
  34.  
  35. Will rebuild .NDX files so you don't have to use PCBpack
  36.      Note - old .NDX file needs to be present so we can
  37.             get the size of it before rebuilding.
  38.  
  39. Will strip hi bit characters from imported mail
  40.  
  41. Will save you money, it's free
  42.  
  43. Will (must!) use file named ORIGIN in your FidoNet message
  44.      directory for origin line.
  45.  
  46. =============================================================================
  47.  
  48.   Contained in Msgswap.zip should be the following:
  49.  
  50.   MSGSWAP.DOC   -   This file
  51.   MSGSWAP.EXE   -   The main program
  52.   MSGSWAP.CFG   -   The nasty example config file
  53.   BOARD.BAT     -   Example of how I EXPORT mail FROM PCBoard
  54.   INTOPCB.BAT   -   Example of how I IMPORT mail INTO PCBoard
  55.   RENUMBER.BAT  -   Example of how I update LASTMSG.PCB after renumbering
  56.  
  57. =============================================================================
  58.  
  59.   Should be a simple matter getting started.  Modify msgswap.cfg to
  60.   reflect your needs.  Format of msgswap.cfg is:
  61.  
  62. 1:273/730               ; fidonet address  ZONE:NET/NODE
  63. c:\opus\echotoss.log    ; path/name of export log file
  64. CURMUDGEON              ; name of fidonet area (used to create echotoss.log)
  65. c:\msg1\curmudge\       ; path to fidonet area
  66. c:\pcb\curmudge\msgs    ; PCBoard path/msgbase name
  67. PCBNET                  ; name of fidonet area (used to create echotoss.log)
  68. c:\msg1\pcbnet\         ; path to fidonet area
  69. c:\pcb\pcbnet\msgs      ; PCBoard path/msgbase name
  70.  
  71.   There may be no blank lines in swapmsg.cfg, comments are OK as long as
  72. they're behind a semi-colon (;).
  73.  
  74. FIRST LINE  - Your complete FidoNet address
  75. SECOND LINE - Complete path + file name of export log file
  76. THIRD LINE  - Name of the FidoNet echo
  77. FOURTH LINE - Complete path to FidoNet message area
  78. FIFTH LINE  - Complete path + file name of PCBoard msgs file
  79. and so forth...
  80.  
  81.  
  82. =============================================================================
  83.  Command line parameters - Entering msgswap by itself gives you this info:
  84.  
  85. MsgSWAP v1.01
  86. Copyright 1991 Swap Bros. Software. All rights reserved.
  87. Written in Clipper S'87 by Chester Swap
  88.  
  89. Usage: MsgSWAP /g:pathname /i or /e 
  90.  
  91.        /g:pathname  = full path + file name for msgswap.cfg
  92.        /i           = import to PCBoard
  93.        /e           = export from PCBoard
  94.  
  95.  
  96.        MsgSWAP /lm:pathname
  97.  
  98.        /lm:pathname = full path + file name of lastmsg.pcb to adjust (option)
  99.  
  100.               use this option after renumbering FidoNet msg areas
  101.  
  102.  
  103. Exit Errorlevel 0
  104.  
  105. =============================================================================
  106.  
  107. Sample usage:
  108.  
  109. msgswap /i /g:msgswap.cfg  - To IMPORT mail TO PCBoard
  110. msgswap /e /g:msgswap.cfg  - To EXPORT mail FROM PCBoard
  111.  
  112. The switches can be in any order and are not case sensitive
  113.  
  114. After running Renum or whatever you use to kill off and renuber your
  115. FidoNet message areas you must run the following to update LASTMSG.PCB:
  116.  
  117. swapmsg /lm:pathname where pathname is complete path to the FidoNet area
  118.                      that was renumbered.
  119.  
  120. So if I renumbered my FidoNet areas PCBNET, and Curmudgeon, I'd run:
  121.  
  122. swapmsg /lm:C:\MSGS1\PCBNET\
  123. swapmsg /lm:C:\MSGS1\CURMUDGEON\
  124.  
  125. Pretty simple huh?
  126.  
  127. =============================================================================
  128.  
  129. ERRORLEVELS:
  130.  
  131. Exits with an errorlevel of 0 if no mail was processed for any area
  132. Exits with an errorlevel of 1 if mail was processed for any area
  133. Exits with an errorlevel of 2 if the sky is falling
  134. Exits with an errorlevel of 3 if a msgs.ndx error - run PCBpack
  135.  
  136. The errorlevels really aren't needed for anything but the EXPORT mode
  137. See example batch files...
  138.  
  139. =============================================================================
  140.  
  141. An export log file is created in /e mode.  It's up to you to kill it.
  142.  
  143. =============================================================================
  144.  
  145.  Why am I writing stuff like this in Clipper you ask?  Because it's easy and
  146. I like it!  Like at the dragstrip, you run what you brung...
  147.  
  148. =============================================================================
  149.  
  150. Changes:
  151.  
  152. 03/29/91 v1.01
  153.  
  154. Exported messages are now chr(0) terminated as per FidoNet specs.
  155. Improved the routines I was using for word wrapping.
  156.  
  157.